Plant Controller Model: REPCGFM_C1
Model was added in Version 24, build on May 1, 2025
AutoCorrection Properties
Following checks and corrections are applied during Validation and AutoCorrection.
- The following parameter pairs should have a maximum value that is positive and a minimum value that is negative:
FRmax/FRmin, Pfreqmax/Pfreqmin, Prefmax/Prefmin, PerrRmax/PerrRmin, Perrmax/Perrmin, QerrRmax/QerrRmin, Qerrmax/Qerrmin, Verrmax/Verrmin, Qvcmax/Qvcmin
If both values are positive, then we will assume the minimum value should have had a negative sign.
If both values are negative, then we will assume the maximum value should have had a positive sign.
If the Max < 0 AND Min > 0, then we will assume the numbers have been entered backwards and we will swap the values. - The following parameter pairs should have a maximum value that is greater or equal to than the minimum value:
Frefmax/Frefmin, Vrefmax/Vrefmin, FFFRhigh, FFFRlow, Qrefmax, Qrefmin
If the Max < Min then the values will be swapped by the Auto Correction. - dbfL1 and dbVSL1 represent low side deadbands which should always be negative. We will assume a parameter equal to the negative of the absolute value entered.
- dbfH1 and dbVSH1 represent high side deadbands which should always be positive. We will assume a parameter equal to the positive of the absolute value entered.
- PFFRhigh <= 0 expected, so we will assume a value of zero if a positive value specified.
- PFFRlow >= 0 expected, so we will assume a value of zero if a negative value specified.
- Tfrq much be at least Mult*TimeStep and will be increased to that if less than this
- Ddn, Dup, DFFR, Kip, Kiq, Kivc, and Kpvc not be negative and will be treated as 0.0 if a negative value is specified.
- Rloss and Xloss should be positive values. Negative or zero values will be treated as an indication that Rloss and Xloss should be auto-calculated as described below.
- For Tfref, TVmeas, TVlag, TVref, TPmeas, TPlag, TQmeas, TQlag, Tvc time constant, any value less than Mult*TimeStep will be modified. If less than 0.5*Mult*TimeStep will be set to 0.0, otherwise it will be increased to Mult*TimeStep.
Mult represents the user-specified value Minimum time constant size as multiple of time step option on the Validation page of the Transient Stability Dialog
TimeStep represents the integration time step being used as described on TimeStep
Model Equations and/or Block Diagrams
Parameters:
| OtherObject:0 | Measurement Bus |
| OtherObject:1 | Measurement Branch |
| OtherObject:2 | Measurement Freq Bus |
| MeasFlag | 0 indicates that positive flow for MeasBranch is leaving MeasBus going out to the line. 1 indicate that positive flow for MeasBranch is arriving at MeasBus coming in from the line. |
| VFlag | A flag to determine if the voltage control for the GFL branch is enabled (<>0) or disabled (0) |
| VrefFlag | A flag to select whether the plant voltage measurement (<>0) or the inverter voltage measurement (0) is used to generate the voltage reference of the GFM branch |
| FFRFlag | A flag to select whether the FFR function is enabled (<>0) or disabled (0) |
| FRmax | Upper rate limiter for the plant frequency measurement [pu/s] |
| FRmin | Lower rate limiter for the plant frequency measurement [pu/s] |
| Tfrq | Time constant of the low-pass filter for site frequency measurement [s] |
| Vfth | Voltage threshold for the plant frequency measurement [pu] |
| Frefmax | Upper limit of the frequency reference generator of the GFM branch [pu] |
| Frefmin | Lower limit of the frequency reference generator of the GFM branch [pu] |
| Tfref | Time constant of the low-pass filter for frequency reference output [s] |
| TVmeas | Time constant of the low-pass filter for voltage measurement [s] |
| TVlag | Emulate the time delay of sending the inverter terminal voltage to the plant controller [s] |
| Rloss | Resistance used to estimate the active power loss of the plant ( If Rloss=0, it will be auto-calculated at initialization so that integrator state for Kip is zero) [pu] |
| Xloss | Reactance used to estimate the reactive power loss of the plant (If Xloss=0, it will be auto-calculated at initialization so that integrator state for Kiq is zero) [pu] |
| Vrefmax | Upper limit of the voltage reference generator of the GFM branch [pu] |
| Vrefmin | Lower limit of the voltage reference generator of the GFM branch [pu] |
| TVref | Time constant of the low-pass filter for voltage reference output [s] |
| dbfL1 | Lower threshold of the frequency deadband [pu] |
| dbfH1 | Upper threshold of the frequency deadband [pu] |
| Ddn | Downside of frequency versus power droop gain [pu] |
| Dup | Upside of frequency versus power droop gain [pu] |
| Pfreqmax | Upper limit of the frequency versus active power droop reference [pu] |
| Pfreqmin | Lower limit of the frequency versus active power droop reference [pu] |
| Prefmax | Upper limit of the active power reference [pu] |
| Prefmin | Lower limit of the active power reference [pu] |
| FFFRhigh | Upper threshold of the Fast Frequency Response function [pu] |
| FFFRlow | Lower threshold of the Fast Frequency Response function [pu] |
| PFFRhigh | Power command of Fast Frequency Response when frequency is higher than fFFR_high [pu] |
| PFFRlow | Power command of Fast Frequency Response when frequency is lower than fFFR_low [pu] |
| TFFR | Time duration of the Fast Frequency Response [s] |
| DFFR | Ramp rate for the Fast Frequency Response to quit operation [pu/s] |
| TPmeas | Time constant of the low-pass filter for P measurement. [s] |
| Kip | Controller gain for the active power path [pu] |
| PerrRmax | Upper limit of the input for the active power path [pu] |
| PerrRmin | Lower limit of the input for the active power path [pu] |
| Perrmax | Upper limit of the integrator for the active power path [pu] |
| Perrmin | Lower limit of the integrator for the active power path [pu] |
| TPlag | Emulate the time delay of sending the P command from the plant controller to the inverter controller [s] |
| Qrefmax | Upper limit of the reactive power reference [pu] |
| Qrefmin | Lower limit of the reactive power reference [pu] |
| TQmeas | Time constant of the low-pass filter for Q measurement [s] |
| Kiq | Controller gain for the reactive power path [pu] |
| QerrRmax | Upper limit of the input for the reactive power path [pu] |
| QerrRmin | Lower limit of the input for the reactive power path [pu] |
| Qerrmax | Upper limit of the integrator for the reactive power path [pu] |
| Qerrmin | Lower limit of the integrator for the reactive power path [pu] |
| TQlag | Emulate the time delay of sending the Q command from the plant controller to the inverter controller [s] |
| Verrmax | Upper limit of the voltage reference [pu] |
| Verrmin | Lower limit of the voltage reference [pu] |
| dbVSL1 | Lower threshold of the plant voltage controller deadband [pu] |
| dbVSH1 | Upper threshold of the plant voltage controller deadband [pu] |
| Kpvc | Controller gain of the plant voltage controller [pu] |
| Kivc | Controller gain of the plant voltage control [pu] |
| Qvcmax | Upper limit of the reactive power of the plant controller [pu] |
| Qvcmin | Lower limit of the reactive power of the plant controller [pu] |
| Tvc | Time constant of the low-pass filter [s] |
| MVABase | Model MVA base (enter 0 to use the machine MVABase) [MVA] |